Best of Shareware

home *** CD-ROM | disk | FTP | other *** search

/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / CAD_CAM / WCEDT202 / WCEDIT.DOC < prev next >

Wrap

Text File | 1992-08-29 | 153KB | 4,282 lines

AutoCAD, ACAD, AutoLISP, and ADS are trademarks of Autodesk, Inc. Documentation by Stew Miller Printed in the U.S.A. CONTENTS USING THIS MANUAL.............................................iii AN OVERVIEW OF WCEDIT......................................... 3 THE EDITOR................................................. 3 CONFIGURABLE............................................... 4 PROGRAMMABLE............................................... 4 AN APPLICATION ENGINE...................................... 4 INSTALLING WCEDIT............................................. 5 USING THE EDITOR.............................................. 6 LOADING THE EDITOR......................................... 6 THE EDITING SCREEN......................................... 7 LINE EDITING........................................... 11 MARKING TEXT........................................... 12 MULTIPLE WINDOWS....................................... 13 RECORDING MACROS....................................... 13 PROGRAMMING............................................ 13 USING THE MOUSE............................................... 15 WINDOW RESIZING........................................ 15 MOVING THE CURSOR...................................... 16 MARKING TEXT........................................... 16 MENU SELECTING......................................... 16 THE MENU SYSTEM............................................... 17 FILES...................................................... 17 COMMANDS................................................... 19 DEFAULT KEYS........................................... 22 LANGUAGE................................................... 25 OPTIONS.................................................... 29 SPELL...................................................... 32 SUPPORT.................................................... 34 APPENDIX A - CONFIGURING WCEDIT............................... 35 CONFIGURATION FILES........................................ 35 WC_COLORS.............................................. 35 WC_HELP_FILE........................................... 36 WC_SETVAR & WC_TOGGLE.................................. 36 WCEDIT VARIABLES....................................... 36 WCCONFIG............................................... 39 APPENDIX B - PROGRAMMING WCEDIT............................... 41 TRIGGER FUNCTIONS.......................................... 42 CURSOR MOVEMENT........................................ 42 EDITING FUNCTIONS...................................... 43 SCRAP-BUFFER........................................... 46 DISK................................................... 48 INQUIRY................................................ 49 WINDOWS................................................ 50 WCEDIT LISP FUNCTIONS...................................... 53 CURSOR MOVEMENT........................................ 53 EDITING................................................ 55 SCRAP-BUFFER........................................... 62 DISK................................................... 62 INQUIRY................................................ 64 SCREEN................................................. 70 INDEX......................................................... 79 USING THIS MANUAL This manual is written for users with different levels of experience. Everyone should start reading on this page, but stop after the appropriate section. An Overview of WCEdit gives a summary of the features and power in WCEdit if you're not sure what Wcedit has to offer. This may be useful for anyone new to WCEdit. If you are not familiar with configuring the AutoCAD environment, Installing WCEdit will help you make sure that you have installed the editor where AutoCAD can find it. Using The Editor describes the editing screen, and explains basic editing functions. Using the Mouse shows how to use the mouse for quick access to special features. The Menu System presents the v2.0 menu system, which makes the powerful features of WCEdit easy to use. Finally, the appendixes Configuring WCEdit and Programming WCEdit contain detailed information for advanced users and programmers. Various typefaces are used throughout the manual to distinguish properties as follows: ALL CAPS File names, such as ACAD.LSP, are shown in capital letters. BOLD CAPS This typeface represents the names of WCEdit functions in text, but not in example programs. Small caps Small caps indicate literal, or combinations of, keys or on your keyboard. MONOSPACE We use mono-spaced typeface to depict text as it appears onscreen or in example programs. Italics Variables and function arguments are italicized, such as int , real , and string . Some arguments that must be passed as strings are shown in double quotes, for example "path". <> Optional arguments are shown in angle brackets. [] Because of the significance of parenthesis in AutoLISP, square brackets are used to set off small examples and notes [like this]. AN OVERVIEW OF WCEDIT ELSA presents WCEdit v2.0 WCEdit v2.0 is brought to you through the gracious support of ELSA America, makers of fine graphics adapters. ELSA has underwritten the development of this software, enabling it to be distributed at a greatly reduced price as shareware. This version is not a demo, not crippled, but is a fully working copy. All documentation is included in the distribution file, ready for printing. Upon registering your copy, you will receive print documents and telephone support. We wish to thank ELSA for their backing, and let you know more about their excellent video boards. On the support menu in WCEdit you will find answers to some basic questions about video coprocessors. That menu also has summaries of ELSA's video boards, their advantages, and features THE EDITOR WCEdit is a totally programmable text editor with special features for editing AutoLISP and AutoCAD menus. WCEdit allows rapid manipulation of extremely large files inside AutoCAD. Since it is an ADS application, written in C language, WCEdit will only run in 386 versions of AutoCAD at this time. Version 2.0 includes many exciting new features, such as full menu access, color coding of AutoLISP files, AutoCAD text and attribute editing, entity listing in AutoLISP format, spell- checking of file and drawings, wildcard support in word searches, a built in ASCII chart, a calculator, and complete UNDO capabilities! WCEdit enables you to perform rapid edit/test cycles on AutoLISP code. Parenthesis and quote checking/highlighting, function and symbol evaluation, and automatic reloading of modified files all add up to lightning fast application development. Plus, WCEdit and your files are maintained in AutoCAD's virtual memory - no more shelling out to your editor. Word processing features such as margins, paragraph indenting, find and replace, and case switching, along with AutoLISP access to all of the editor functions, round out WCEdit's matchless performance. Now you have an editor inside AutoCAD, and AutoCAD inside your editor! CONFIGURABLE You can easily reconfigure the default settings to meet your preferences using intuitive control panels on the pull-down menus. This includes screen colors, and a customizable help file. Editing functions and AutoLISP macros can be mapped to any key or key sequence, including extended keys. Most people modify this mapping to emulate their favorite editor. Several common layouts are selectable from the menus. PROGRAMMABLE WCEdit's real strength lies in flexibility, using a language that you are already familiar with: AutoLISP! What better macro language could be chosen for an AutoLISP editor? User-defined functions can run inside the editor to perform tasks for specific needs, and can be assigned to keystrokes like WCEdit functions. AN APPLICATION ENGINE WCEdit gives you powerful programming extensions for AutoLISP. AutoLISP functions can perform standard editing functions such as search, delete, and insert text. Or you can write functions in AutoLISP that call WCEdit functions discretely, without the editor being visible. You can retrieve text from, write text to, or otherwise manipulate the files in the editor, during any AutoLISP routine. WCEdit allows you to access data files directly, instead of sequentially, as AutoLISP does. INSTALLING WCEDIT After placing the WCEdit distribution diskette in your floppy drive, make that the current drive by typing A: (or B: as the case may be) and Enter at the DOS prompt. Next type install then Enter to start the installation routine. The installation program will prompt you for the drive and directory to which it should copy the WCEdit files. AutoCAD must be able to locate and load the WCEdit program, WCEDIT.EXP, and it's support files. This is controlled by setting the DOS environment variable, ACAD, to the path AutoCAD should use when searching for it's library files. For example, set ACAD=c:\lisp;c:\acad\lib;c:\wcedit would cause AutoCAD to look in the \lisp, \acad\lib, and the \wcedit directories of the C drive for library files (i.e. fonts, blocks, and ADS applications). If WCEdit is not in a directory that is listed in the ACAD variable, AutoCAD will probably not be able to load the editor. See your AutoCAD Installation and Performance Guide for more information on setting this variable. Network users may maintain separate configurations by setting another environment variable, WCEDIT, to the directory from which WCEdit should get help and configuration files. NOTE: if the WCEDIT variable is set, WCEdit will NOT search the path set in the ACAD variable. For example, set WCEDIT=s:\ads\kim would force WCEDIT to use Kim's settings in that directory. WCEdit writes configuration files itself, but the help file must be placed there by the user or system administrator. USING THE EDITOR WCEdit holds your files in memory continuously, even while you return to the AutoCAD Main Menu and load another drawing. This allows you to edit, save, reload, test them in AutoCAD [or the editor], and return to the same place to continue editing. The edit/test cycle is enhanced even further by the editors ability to load AutoLISP files that have been edited and run them while in the editor. WCEdit will warn you if you attempt to exit AutoCAD without saving your edited files, and give you an opportunity to save. Upon exiting AutoCAD, WCEdit saves the names of, and your positions in, the files that are loaded. The next time you run WCEdit, these files are reloaded automatically. LOADING THE EDITOR To load WCEdit type (load "WC") at the AutoCAD command prompt. This will load the WC.LSP file and WCEDIT.EXP if it has not been loaded yet. WC.LSP contains the C:WC function that is used to enter the editor from the AutoCAD command prompt. If no files are currently loaded, you will be prompted for the filename to edit. WCEdit can maintain up to two hundred files in memory at one time. We will refer to these as buffers from hereon, with files referring to the text files on your disk. If you enter the name of a file that does not exist, a new buffer will be created with that name. After this, type WC at the command prompt to re-enter WCEdit. THE EDITING SCREEN When you enter WCEdit you will see the editing screen, with a single editing window. The blinking cursor points to your current position in the buffer, and indicates the insert mode is on by becoming pronouncedly larger. Inset in the window border is the name of the file in that window, See The Menu System for information on using the menus. On the left side of window is a scroll bar that indicates your relative position in the buffer [See Using The Mouse]. The top line of the screen contains the names of the pull-down menus. Pressing the alternate key and the highlighted letter of a menu name, at the same time, will pull- down that menu. ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ _ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ╚══════════════════════════════════ ELSA.TXT ══════════════════════════════════╝ WCEdit V2.01 (C) 1991,92 by ELSA America, Inc Line 10 Col 5 │#│ │ │ At the bottom of the screen is the status line, which displays messages and prompts, the position of the cursor (line and column), and symbols indicating the state of several keys on your keyboard. Those keys are: Shift state | Num lock | Scroll lock | Alt key | Control key. The screen may be split horizontally or vertically into two editing windows for viewing two buffers [see Default Keys], but you may only edit in one window at a time. You may also work with the same buffer in two windows, allowing you to work on the top and bottom of the same buffer simultaneously. Split screens look like this: ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ╠══════════════════════════════════ ELSA.TXT ══════════════════════════════════╣ _ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ░ ║ ╚═════════════════════════════════ RATTAIL.LSP ════════════════════════════════╝ Line 1 Col 1 │#│ │ │ Or this: ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ║ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ░ ║ ░ ╚═══════════════ AUDIO.LSP ═══════════════╩═════════════ ELSA.TXT ═════════════╝ Line 2 Col 1 │#│ │ │ WCEdit maintains another buffer at all times, the Scrap buffer. This works like a clipboard for cut and paste tasks. Text may be copied or moved to, and inserted from the scrap buffer into other buffers. WCEdit can also put text from other sources in the scrap buffer, such as the AutoCAD text screen and listed entities, for inserting in the editor. Although the scrap buffer is not normally visible, you may view the scrap buffer any time you wish by pressing Alt-v [default]. A commonly used window is the Command window. This window pops up when you press the Ctrl-shift key combination, mouse button 2, or select Commands from the Command menu. It contains a list of commonly used commands for easy access. The most recently selected command is highlighted. The commands listed are easily assigned and removed via the Function control panel, described in The Menu System. ╔[Cancel]═══ New File ══════[OK]═╗ ║Filter: *.lsp ║ ║C:\ACAD\ACLISP\ACAD.LSP ║ ╠═══╦═════════════╦══════════════╣ ║C: ║.. ║1185.LSP ║ ║D: ║ ║1TO5.LSP ║ ║ ║ ║3D.LSP ║ ║ ║ ║ACAD.LSP ║ ║ ║ ║ADDNUM.LSP ║ ║ ║ ║ALIGN.LSP ║ ║ ║ ║ANSI.LSP ║ ║ ║ ║ARO.LSP ║ ║ ║ ║ASCTEXT.LSP ║ ║ ║ ║ATOUT.LSP ║ ║ ║ ║ATTREDEF.LSP ║ ╚═══╩═════════════╩══════════════╝ File Dialogue Box One other window is used by several functions, the File Dialogue Box. This dialogue box is used whenever WCEdit needs the name of a file to load or view. The window opens with the cursor on the second line, and the name of the last file read is displayed for editing. If you type any character, instead of an editing key, the old filename will be removed from the line to make room for a new name. A filename can be selected from a list by moving the cursor down with the Tab or Arrow keys, and selecting a drive. Then right to select a directory, and right again to select the file. For fast file selection, if you type a character, the cursor will move to the first file beginning with that letter. Pressing that character again will move the cursor to the next file, and so on. Press Enter to select the file to be retrieved. The file list can be narrowed by using the Filter feature on the first line. To search for strings of text, use F5 to start the Find command. Find prompts you for the search-string, and will accept a ? as a wildcard in the string. Ctrl-F5 is a multi-buffer text search routine. Like the Find command, a box appears prompting you for the string to search for. If you had 10 files loaded, and wished to find which files contained the 'apples', Ctrl-F5 would search each buffer in the editor for this string. If found, the cursor is placed at that first position of the find sequence. A window then appears showing which of the buffers the string was found in. Selecting one of the buffers will make that buffer the active buffer, with the cursor upon the find string. Subsequent calls to the routine with the same search string results in a prompt to retain the previous list. The next file in the list will then be highlighted. Find and replace is executed by pressing F6. This will open a window for entering the string to find, and the string to replace. Press F10 to accept the strings for find and replace. If a question mark [?] is included in the find string, a query box will be displayed asking if the question mark is a wildcard. For example, entering t?o as the find string will prompt: "Use '?' as a wildcard?". If the user responds yes to this query, then the following words would be accepted as equivalent: too, two, tao, tbo, t1o, etc. Next, you may enter a list of non-wildcard characters, to limit the scope of the find. For example, if the non-wildcards for the above example were "wab" then the following words would be overlooked in the find sequence: two, tao, tbo. At each occurrence of the find string, you may perform the following functions: Yes - Replace this and continue through the buffer. No - Ignore this and continue through the buffer. All - Change all occurrences in the buffer without question. One - Change just this one occurrence and stop. Undo - Step back through previous changes made and undo them. At the last occurrence of the find string in the file, one of two prompts will appear, depending upon the state of the variable entitled "Next file with find and replace". If the variable is off then the following question will appear: Changed: x in text Top of file/Next file/<stop> Responding with a 'T' will continue the find and replace at the top of the file, an 'N' will toggle to the next file [if more than file has been loaded], and any other key will cause find and replace to stop. If the variable is on, then the prompt "Change in all files without prompt?" will appear. Answering yes will result in ALL buffers currently loaded being run through find and replace, and all matches replaced. LINE EDITING You may join two lines by moving the cursor to the end of the line and pressing Delete. Additionally, placing the cursor on the first column of a line and pressing Backspace will move that line up to the end of the preceding line [see variable BSPACE_WRAP for controlling this feature]. WCEdit does not support tab characters. Tabs in files being read in will be converted to spaces [see Tab width under Commands menu/Variables]. Pressing Tab with the insert mode on will also insert the appropriate number of spaces. If you prefer working with the insert mode off, the tab key merely moves the cursor to the next tab position. MARKING TEXT Marking text allows you to perform functions on the entire block of text. Place a mark by placing the cursor at the start of the block, and beginning the type of mark desired. INCLUSIVE marking [F9 or mouse] may start anywhere on a line, wraps around the end of lines, and may stop anywhere on a line. COLUMN marking [Alt- f9] blocks a rectangle of text, including spaces. LINE marking [Ctrl-f9] blocks entire lines regardless of the position of the mark on the line. Dynamic marking allows you to drag the end of the mark using the arrow keys or your mouse. This works with any type of mark. To stop marking, press the marking key which started your mark. The method with which text was marked is remembered by WCEdit when the text is cut to the scrap buffer. That mode is then used when inserting the text from the scrap buffer. For example, if the scrap buffer contained this text, BBBBB BBBBB and your text file looked like this, AAAAA AAAAA AAAAA inserting with the line mode would produce this, AAAAA BBBBB BBBBB AAAAA AAAAA and inserting with the column mode would cause these results, AAAAA BBBBBAAAAA BBBBBAAAAA Text is normally pasted from the scrap buffer as if the insert mode were on. MULTIPLE WINDOWS WCEdit allows you display one or two windows at the same time, and control which buffers are viewed in each window. You may split the screen either horizontally or vertically, and size the windows to meet your needs. Alt-1 and Alt-2 both split at the center of the screen, vertically or horizontally. Alt-3 and Alt-4 split the screen vertically and horizontally at the current cursor position. To resize the windows, position the cursor using the arrow keys or the mouse, and reinvoke the Alt-3 or Alt-4 command. Different buffers may be viewed in each window, or the same buffer may be displayed in both windows, allowing you to view different portions of the same file [like AutoCAD Viewports]. You can cut and paste from one buffer to another, or from one window to the other window. To toggle to the other window press Alt-n, or use the mouse to reposition the cursor. Alt-z will zoom the current window to fill the screen, returning you to single-window mode. RECORDING MACROS Pressing F7 starts the macro recording feature. This logs every key stroke you enter until F7 is press again. The macro may be replayed by pressing F8 at any time before you leave AutoCAD and return to DOS. This handy feature saves time and increases accuracy in repetitive operations. Macros may be saved to files by selecting the save macro function from the Commands menu. We recommend that you be using only one keyboard layout if you intend to use recorded macros. Because WCEdit records keystrokes, not functions, playing back a macro under a different keyboard configuration may produce unforeseen results. PROGRAMMING WCEdit's powerful programming functions make it unparalleled for AutoLISP and AutoCAD menu editing. No other editor matches WCEdit's capability and features. Start by pretty printing AutoLISP code. WCEdit will indent your AutoLISP code, using the current tab setting and the left margin using Ctrl-p. Opening parentheses are tabbed and closing parentheses aligned with their matching colleague. Of course, nesting of pairs is taken into consideration, as are comments and strings [This feature can be disabled from the Variables menu]. Next, robust parentheses and quote checking confirm the integrity of your code. Parenthesis and quotes that are located inside of strings and comments are ignored. These exclusions can be disabled, via the Variables menu, to force WCEdit to scrutinize every occurrence of these characters. A single parenthesis/quote comparison is performed by placing the cursor on a parenthesis or double quote and pressing F3. The cursor is moved to the balancing character. An invalid match usually results in the cursor being moved to the beginning or end of file. A chirp and prompt notify you of such an error. The entire buffer may be checked by striking F4. The soundness of the code will be announced, along with a count of the matching pairs. More AutoLISP control is contributed by several external commands. Available on the F10 command menu, they merit their own function key also. "Inspect, write and load the current AutoLISP file" runs a full paren/quote check and writes the buffer to disk. If these steps are completed satisfactorily, the file is reloaded via (load "filename"). For easy testing of AutoLISP routines, you can run one with "run AutoLISP function" option on the Language menu. These commands work in unison to create the fastest check/reload/run debugging cycle available. Menu editing functions add further to WCEdit's programming fortitude. A press of Ctrl-t will clean all trailing [end of line] space characters from a buffer. This is especially valuable because of AutoCAD's interpretation of spaces as the Enter key in menus. USING THE MOUSE Mouse input is supported at almost every phase in the editor. Uses include: Moving the cursor Marking text Menu selection Window resizing While discussing the mouse, "Picking" refers to pressing button number one (usually the left button) and releasing it. "Double clicking" denotes pressing button number one twice, rapidly. "Dragging" means holding the button down while moving the pointer. The mouse pointer is a reverse-video rectangle (█), which should not be confused with the editor's blinking cursor (). Button number two [normally the right button], pops up the Command Window, which contains your favorite commands. See Using the Editor for a description of the Command Window. WINDOW RESIZING When working with a split screen, you may wish to change the size of the windows. Window resizing is performed with the mouse by placing the pointer on the crossbar between the windows, and dragging the bar into its new position. MOVING THE CURSOR Picking in a window will move the cursor to that location. Dragging the cursor to the left, right, up, or down, will scroll a window in that direction, leaving the cursor at the pointer location when you release the button. Scrolling speed may adjusted from the Variables menu or with the variable MSSPEED [see WC_SETVAR]. The scroll bar on the left side of the windows can be used to scroll the buffer quickly. The bar represents the length of the buffer, with a double arrow () showing the relative position in the buffer. Dragging the double arrow up or down will scroll the buffer in that direction. Picking above or below the double arrow will cause the window to scroll one page up or down. For more ways to move around in the editor, see Cursor Movement. MARKING TEXT The mouse offers a quick way to mark blocks of text. The mouse marks text with an "inclusive" mark, which may begin and end anywhere on a line, and wraps around at the end of lines in between. To mark text, put the cursor at the beginning of the text to be marked, double click and drag the pointer to the other end of the text. Other types of text marks are described under Marking Text. MENU SELECTING Picking a menu title on the top line will pull that menu down. Selections may be made by picking the desired option, typing the highlighted letter, or by moving the cursor bar with the cursor keys and pressing enter. THE MENU SYSTEM The top line of the editor screen displays seven menu titles, similar to the AutoCAD menu bar. You may pull down a menu by picking the menu's title with the mouse, by pressing the Alternate key and the highlighted letter of the title together, or by using the Ctrl-shift key combination. The cursor is displayed as a highlighted bar both on the titles and menu option. Using Ctrl-shift will pull down the menu which was used last, with the cursor bar on the previously used selection. You may pick an option by either moving the cursor with the arrow keys and pressing Enter, or by picking with mouse pointer. Many of the functions may be accessed directly with their own key strokes. See Default Keys for a listing of key assignments. Pressing Escape will always exit the current menu, returning you to the previous menu, or to the editor. FILES ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌───────────┐ ║ │about │ ║ │New │ ║ │Toggle file│ ║ │Write to: │ ║ │Read in │ ║ │save/eXit │ ║ │buffer List│ ║ │rePlace │ ║ │Quit │ ║ └── Elsa ───┘ ║ ░ ║ The first menu is the Files menu. It contains functions to read and write files, and switch from one buffer to another. Since WCEdit stays in memory continuously while you are in AutoCAD, the buffers are also maintained in memory. This means the contents of the buffers are not lost when you quit the editor to work in AutoCAD. If you exit AutoCAD without saving the buffer[s], WCEdit will warn you of unsaved work and give you the opportunity to save. Conversely, WCEdit will ignore save commands if nothing has been changed. Following is a description of each Files option. The about option will tell you the latest information about the author and copyright of the software. New prompts the user for a file to edit using the File Dialogue Box described in The Editing Screen. If that selected file is already loaded, it will be switched to; if not, WCEdit will open a new buffer with that name and make it the active buffer. If a file is found with that filespec [path and filename], it will be read into the new buffer. If not, the new buffer will remain empty. Up to two hundred buffers may be open at one time. The buffers may be shifted through in the current window by using the Toggle file option. Buffers are loaded into memory in a ring pattern. When the last buffer in the ring is reached, the window shifts back to the first buffer. Note that the scrap buffer is not a part of this ring. Write to prompts the user for a file to write the current buffer to. The current filename assigned to the buffer is the default, like AutoCAD's SAVE command. Another file may be read into the active buffer with the Read in function. The file will be "stuffed" line by line at the cursor position, as if typing with the insert mode on. This can be used to combine two files, or to create a new file that is equivalent to an existing file. For example, open a new buffer that is empty with the New option, then read in the existing file with the Read in command. The alternative is to use the DOS copy command, for example copy exist.txt new.txt. By selecting save/eXit you will write the current buffer to the disk, and return to the AutoCAD command prompt. No questions, no prompts. The buffer List option pops up a window displaying all of the currently open buffers. You may pick one to edit, or delete any except the last one [the editor must always keep one buffer open, even if it is empty]. Select another buffer by moving the cursor to it and pressing enter, by pressing the letter next to the filename [A, B, C, etc], or by picking it with your mouse. The rePlace option works just like the New function, creating or reading in a new file (if it exists). The difference is that instead of adding the new file to the ring, it replaces the current buffer. You will be prompted to save if you have made changes. Quit exits the editor, simply and quickly. Files that weren't saved will not be lost. Buffers are retained in memory by the editor until you return. COMMANDS WCEdit's editing environment is easily defined, and redefined, from the menu system or by using an AutoLISP configuration file. The easiest method is through the menu access to variables, key functions, and color assignments. Picking the Commands option gives you access to common commands, editor variables, and the editor configuration panels. ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ╔══════════════════╗ ║Commands ║ ║Variables ║ ║configure Keys ║ ║Reset defaults ║ ║Write config file ║ ║Help ║ ╚══════ Elsa ══════╝ The first is the Commands option, which pops up the Command Window. ╔═══════════════════════════════════════════════════════╗ ║Find and replace F6 ║ ║Find F5 ║ ║Repeat last find Alt F5 ║ ║Delete to end of line Alt K ║ ║Delete this line Alt H ║ ║Begin an inclusive mark F9 ║ ║De-highlight block Ctrl E ║ ║Copy block to scrap buffer Ctrl K ║ ║Paste in the scrap buffer Alt I ║ ║Cut and paste block Alt M ║ ║Delete marked text Ctrl D ║ ║To top of file Ctrl PgUp║ ║To end of file Ctrl End ║ ║Goto line Alt G ║ ║Split the screen at position vertically Alt 3 ║ ║Split the screen at position horizontally Alt 4 ║ ║Zoom the current buffer to full Alt Z ║ ╚═══════════════════════════════════════════════════════╝ Command window The Command window lists additional commands that aren't accessible from the menu system, and their assigned key strokes. Displayed functions may be executed by picking them from the list. The window can also be popped up using mouse button 2, or the Ctrl-Alt key combination. You can change which commands are displayed in the window by using the configure Keys option, described further on. An explicit list of available commands can be found in the Default Keys appendix, or the Help window of WCEdit [F1]. ╔════ Select a Variable to change ════╗ ║Tab width ║ ║Right margin ║ ║Word wrap ║ ║Backspace wrapping ║ ║Left margin ║ ║Mouse window scroll speed ║ ║Show end of line ║ ║Reverse cursor display ║ ║First word in paragraph ║ ║Config auto save ║ ║Kill undo chain at file write ║ ║Next file with find & replace ║ ║Dictionary loading in speller ║ ║Display of files in file window ║ ║Dual screen display ║ ║Color painting mode ║ ╚═════════ Escape to exit ══════════╝ Variables control panel The Variables option displays the descriptions of various editor variables that can be toggled or adjusted; such as tab width, margins, cursor size, and the insert mode. Selecting a description will toggle that variable on or off and display the current status on the bottom line of the display. For variables that cannot be toggled, you will prompted for the new value [ e.g. Right margin: 10 ]. Although most of the descriptions are sufficient, the Variables appendix gives a detailed description of each one. The configure Keys menu lets you assign functions to key strokes using the Function Control Panel. The first column of the panel gives the description of each function. The second shows which key [if any] is assigned to it. If more than one key is assigned to that function, the number of keys is shown in the third column. Next, an asterisk [*] denotes that the function is external. External functions are separate AutoLISP routines that are not built in to the editor. You may assign external functions to keys also, after you have registered them with WCEdit [See the Programming appendix]. The last column shows a checkmark [√] next to functions that are displayed in the Command window. ╔═══════════════ Instructions ════════════════════════════ Meaning ══════════╗ ║You may alter the key assigned to this action,│Number of keys assigned ║ ║delete the key match or add-remove this action└───────┐ * is external ║ ║from you Command pop up window accessed by <Ctrl-Alt>.└───┐ √ Is in Pop up ║ ╠═══════════════ Description ══════════════ Assigned to Key ═══════════════╣ ║Record and End record a key stroke macro. F7 ║ ║Play back the current key stroke macro. Alt F7 ║ ║Delete marked text or line to scrap Pad - ║ ║Re-highlights previous block Ctrl R ║ ║Reformat block into paragraph NOT ASSIGNED ║ ║Remove all trailing white space Ctrl T ║ ║Move to next word Ctrl Right ║ ║Move to previous word Ctrl Left ║ ║Write the current buffer to disk Alt W ║ ║Write file to ... Ctrl W ║ ║Write all files to disk Ctrl F1 ║ ║Create/Load a new file Alt E ║ ║Edit/Delete another buffer Alt B ║ ║Save-as and exit to AutoCAD Ctrl X ║ ║Quit to AutoCAD Alt Q ║ ║Toggle to next buffer Alt - ║ ║Toggle to next window Alt T ║ ║Split the screen at center vertically Alt 1 ║ ╚════════════════════════════════════════════════════════════════════════════╝ Function Control Panel To change the key or Command window assignments for a function, pick it from the menu. You will see a menu with five actions from which to choose: ╔═══════ Key ══════╗ ║ Overwrite pair ║ ║ Add another key ║ ║ Delete pair ║ ║ Edit description ║ ║ toggle Pop up? ║ ╚═════ Escape ═════╝ One, Overwrite pair will assign a new key to the function, deleting the old assignment. Two, Add another key will assign an additional key to the function. Three, Delete pair will remove all key assignments from that function. Four, Edit description will do just that. This description is displayed in the command window. And five, toggle Pop up will add or remove the function from the Command window. In case you've deleted references to functions, you are first asked if you would like to restore the deleted functions. Answering yes will restore all deleted functions. DEFAULT KEYS The functions assigned to the following key strokes and key combinations are the default WCEdit configuration. These functions may not be available if a different configuration is used. For configurement information see CONFIGURING WCEDIT on page 35. FUNDAMENTAL KEYS The Enter key moves the cursor to the first column of the next line down. If insert mode is off, a new line is not added. If insert is on, the line will be broken at the cursor position, moved down one line, and the cursor placed in the first column of the new line. The Tab key moves the cursor 5 characters [by default] to the right. If insert mode is on, spaces are inserted. View the help F1 Quit to AutoCAD Alt-q Undo last command Alt-u Set an undo mark Ctrl-s Undo back Ctrl-u CURSOR MOVEMENT Move to next word Ctrl-right Move to previous word Ctrl-left Beginning of line Home Top of page Home home Top of buffer Home home home or Ctrl-home End of line End Bottom of screen End end Bottom of buffer End end end or Ctrl-end Go to line # Alt-g LINE EDITING Insert line above Alt-enter the current position. Delete line Alt-h Delete to end of line Alt-k BLOCKING TEXT begin inclusive mark F9 begin line mark Ctrl-f9 begin column mark Alt-f9 [pressing any mark key will end the mark] Erase marks [unmark] Ctrl-e Rehighlight previous block Ctrl-r Copy block or current line Ctrl-k to scrap buffer [overwrites] Cut block or current line Keypad-minus [-] to scrap buffer [overwrites] View scrap buffer Ctrl-v Insert scrap buffer Alt-i Delete block Ctrl-d Delete block, fill w/space Ctrl-f Move block [in same buffer] Alt-m FILES Read in a file Alt-r [appends to current] Edit new file Alt-e Write file Alt-w Write file to... Ctrl-w Write and quit Ctrl-x Write all files Ctrl-f1 Select buffer from list Alt-b Rename buffer Ctrl-o View a file Alt-v Import AutoCAD text screen Ctrl-i to scrap buffer SCREEN CONTROL Toggle to next window Alt-n Switch to next buffer Alt-dash [-] in current window Remove current buffer Ctrl-dash [-] Split screen Vertical Alt-1 at cursor Split screen Horizontal Alt-2 at cursor Split screen Vertical Alt-4 at center Split screen Horizontal Alt-5 at center Zoom current window Alt-z TEXT Paragraph reformat Ctrl-z Find string F5 Repeat find Alt-f5 Find in all buffers Ctrl-f5 Find & replace F6 Repeat find & replace Alt-f6 Change the case of text Ctrl-c Remove Trailing white space Ctrl-t PROGRAMMING Paint parenthesis [temporary] F2 Single bracket/quote F3 comparison [Place the cursor on a parenthesis or double quote before using F3] Multiple bracket/quote F4 comparison Begin or end a macro record F7 Playback current macro Alt-f7 Select command from list F10 of external commands Run non-registered AutoLISP Alt-f1 Pretty print LISP data Ctrl-p Insert column of numbers Ctrl-n The next option on the commands menu is Reset defaults. This will reset everything configurable in WCEDit: colors, variables, key assignments, screen resolution, etc. You will be prompted for a yes or no before resetting. Once you have adjusted WCEdit the way you like, the Write config file option will create a configuration file, including colors, variables, and key/function assignments. This file will normally be written in the directory where WCEDIT.EXP is stored. The exception is when the DOS variable WCEDIT is set to another directory [WCEDIT=x:\mydir]. See Installing WCEdit for a description of the WCEDIT variable. WCEdit can be set to save configuration changes automatically through Config auto save on the Variable control panel. Selecting Help will pop up the Help window, just as the F1 key does. LANGUAGE ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌──────────────────────┐ ║ ░ │Color mode toggle │ ║ ░ │Reformat file <Lisp> │ ║ ░ │Match parenthesis │ ║ ░ │check all Parenthesis │ ║ ░ │list Selected entities│ ║ ░ │ascii cHart │ ║ ░ │calculaTor │ ║ ░ │run AutoLISP function │ ║ ░ └──────── Elsa ────────┘ ║ The Language menu offers features for enhanced AutoLISP programming. Many of these functions are helpful for C programming also. Color mode toggle is for viewing and editing AutoLISP code. It will change the display from the default colors to a black background with color coded parenthesis. The text inside quotes [""] will be shown in grey. This is extremely useful for finding misplaced parenthesis and quotes. After using the function several times, the mis-colored code caused by a mistake will stick out like an elephant in a strawberry patch. The contents of each level of parenthesis may be colored also, by changing "Full color on color mode" on the Variables control panel. Reformat file <Lisp> will pretty print your AutoLISP code. Each line will be indented based on the level of parenthesis. The amount of indent is controlled by the tab width, which you can set on the Variables control panel. This feature is also useful for finding errors in your code. Match parenthesis is used by placing the cursor on a parenthesis, then selecting this option. The cursor will be moved to the corresponding open or close parenthesis. Running the function again should return you to your original position. You can cause WCEdit to ignore parentheses inside comments [;] by changing "Comments considered in bracket test" on the Variables control panel. check all Parentheses performs similar to Match parenthesis, but the entire buffer is checked for matching pairs of parenthesis. WCEdit will stop checking at the first error it finds, which should be near your mistake. You will be told if all pairs match. list Selected entities is similar to the AutoCAD List command, however, the entities are listed in AutoLISP [or DXF] format for programming purposes. After selecting this option, you will see the AutoCAD editing screen and the Select objects prompt. The entity list will be displayed for viewing in the WCEdit scrap buffer window. If you wish to edit the list, you may insert the scrap buffer into the buffer you are editing [with "Paste in the scrap buffer" from the command window or using Alt-i]. Here is a sample listing of a circle: ─────────────────────────────────────────────── Item #0 (-1 . <Entity name: 6000001a>) (0 . "CIRCLE") (8 . "0") (10 . 7.000000 11.000000 0.000000) (40 . 3.141593) (210 . 0.000000 0.000000 1.000000) END LIST Entity list ╔══════════════════════════════════════════════════════════════════════════════╗ ║ 1 2 3 4 5 6 7 8 9 ° 10 11 12 13 ║ ║ 14 15 16 17 18 19 20 21 22 23 24 25 26 ■ ║ ║ 27 28 29 30 31 32 33 ! 34 " 35 # 36 $ 37 % 38 & 39 ' ║ ║ 40 ( 41 ) 42 * 43 + 44 , 45 - 46 . 47 / 48 0 49 1 50 2 51 3 52 4 ║ ║ 53 5 54 6 55 7 56 8 57 9 58 : 59 ; 60 < 61 = 62 > 63 ? 64 @ 65 A ║ ║ 66 B 67 C 68 D 69 E 70 F 71 G 72 H 73 I 74 J 75 K 76 L 77 M 78 N ║ ║ 79 O 80 P 81 Q 82 R 83 S 84 T 85 U 86 V 87 W 88 X 89 Y 90 Z 91 [ ║ ║ 92 \ 93 ] 94 ^ 95 _ 96 ` 97 a 98 b 99 c 100 d 101 e 102 f 103 g 104 h ║ ║105 i 106 j 107 k 108 l 109 m 110 n 111 o 112 p 113 q 114 r 115 s 116 t 117 u ║ ║118 v 119 w 120 x 121 y 122 z 123 { 124 | 125 } 126 ~ 127 128 Ç 129 ü 130 é ║ ║131 â 132 ä 133 à 134 å 135 ç 136 ê 137 ë 138 è 139 ï 140 î 141 ì 142 Ä 143 Å ║ ║144 É 145 æ 146 Æ 147 ô 148 ö 149 ò 150 û 151 ù 152 ÿ 153 Ö 154 Ü 155 ¢ 156 £ ║ ║157 ¥ 158 ₧ 159 ƒ 160 á 161 í 162 ó 163 ú 164 ñ 165 Ñ 166 ª 167 º 168 ¿ 169 ⌐ ║ ║170 ¬ 171 ½ 172 ¼ 173 ¡ 174 « 175 » 176 ░ 177 ▒ 178 ▓ 179 │ 180 ┤ 181 ╡ 182 ╢ ║ ║183 ╖ 184 ╕ 185 ╣ 186 ║ 187 ╗ 188 ╝ 189 ╜ 190 ╛ 191 ┐ 192 └ 193 ┴ 194 ┬ 195 ├ ║ ║196 ─ 197 ┼ 198 ╞ 199 ╟ 200 ╚ 201 ╔ 202 ╩ 203 ╦ 204 ╠ 205 ═ 206 ╬ 207 ╧ 208 ╨ ║ ║209 ╤ 210 ╥ 211 ╙ 212 ╘ 213 ╒ 214 ╓ 215 ╫ 216 ╪ 217 ┘ 218 ┌ 219 █ 220 ▄ 221 ▌ ║ ║222 ▐ 223 ▀ 224 α 225 ß 226 Γ 227 π 228 Σ 229 σ 230 µ 231 τ 232 Φ 233 Θ 234 Ω ║ ║235 δ 236 ∞ 237 φ 238 ε 239 ∩ 240 ≡ 241 ± 242 ≥ 243 ≤ 244 ⌠ 245 ⌡ 246 ÷ 247 ≈ ║ ║248 ° 249 ∙ 250 · 251 √ 252 ⁿ 253 ² 254 ■ 255 ║ ╚═══════════════════════════════ Escape cancels ═══════════════════════════════╝ ASCII chart Selecting ascii cHart pops up a window containing the extended ASCII character set. Both the character number and the character are displayed. Selecting a character will insert that character at the cursor position. You may need to delete the first 27 characters from this chart for printing purposes. ╔══════════════════════════════════════╤════ Variables ═════╗ ║Result Decimal: 2 │r 5 ║ ║Result Hex : 0x2 │a 78.53981634 ║ ║──────────────────────────────────────┤v 392.6990817 ║ ║r=5· │wcedit 2 ║ ║a=pi*r^2· │ ║ ║v=pi*r^3· │ ║ ║wcedit=2 │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ║ │ ║ ╚══ Enter key evaluates expression ════╧════════════════════╝ ╔════════════════ F2 Resets the calculator ═════════════════╗ ║Operators are: = + - * / % ^ sin cos tan atan ln exp pi ║ ║Variables may be set at any time. Each line is evaluated ║ ║upon the striking the ENTER key. ║ ╚═════════════════════ Escape to exit ══════════════════════╝ The Calculator The calculaTor option pops up a decimal/hexadecimal calculator. This calculator supports multiple equations, and the use of variables anywhere in those equations. All supported functions are listed at the bottom of the calculator. For example: r = 10.3 x = sin(60 / 180 * pi) y = r*x When you press Enter, the equation and variables are evaluated, and the value of the line displayed at the top in both decimal and hexadecimal. On the right side, the values of any variables are displayed. If you set more variables than fit in the window, you may tab over to the variable window and scroll through them. To evaluate (run) an AutoLISP function, select the run AutoLISP function option. Enter the function name in the box provided. Either of these examples would be valid: ssx, wc_shave, c:tag This is a handy way to test a function you a writing, without exiting the editor. If the function run without an error, you will return to the editor. OPTIONS ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌───────────────┐ ║ ░ │Low resolution │ ║ ░ │High resolution│ ║ ░ │Colors │ ║ ░ │Mouse │ ║ ░ └──── Elsa ─────┘ ║ The first two selections on the options menu are Low resolution and High resolution. They work only with EGA/VGA video systems, changing the number of lines on the screen to 25 or 43/50. The Colors option brings up the Color control panel. Two colors sets are configurable from the control panel. The editor colors are the colors with which text editing windows are displayed. The pull down colors are the colors used for ALL windows which are displayed on top of the editor windows, in contrast to the editor. The Color control panel presents a sample of editor screen components on the right, and a palette of colors to choose for each component in the upper left corner. The names of each component are on the lower left. You may move the arrows pointing to the names and colors with either the cursor movement keys or mouse pointer. Move up and down to select a component. Move left and right to select a color for that component. The colors selected are shown in the examples on the right. Some background colors will cause the display to blink. This can be disabled with F2. You may exit without saving any changes, if you like. Selecting Mouse lets you enable or disable mouse support in WCEdit. DWGTEXT ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌───────────────┐ ║ ░ │Paste │ ║ ░ │Get text │ ║ ░ │Update │ ║ ░ │Change style │ ║ ░ │Text mode │ ║ ░ └──── Elsa ─────┘ ║ The Dwgtext menu give you access to text and attribute entities in your AutoCAD drawing from WCEdit. Text can be edited in a paragraph format instead of one line at a time. Style and justification can also be changed from the editor. Paste will put the text from the current buffer into your drawing. If text is marked in the buffer, the marked portion will be inserted. Otherwise the entire buffer will be inserted. Using the current style and layer, WCEdit will prompt you for the insertion point and the rotation angle. Get text will put text from your drawing into the editor. The following prompt will be displayed in the drawing editor: All/Select/Text only/Blocks-attributes only <All>: Use A to select all of the text and attributes, S to select text using any options available at the Select objects prompt, T to select all of the text in the drawing, and B to select all of the blocks/attributes. The selected text will be brought into a new buffer called AUTOCAD.TXT, replacing that buffer if it already exists. You may then edit the text using any WCEdit features. After editing text that was retrieved from the drawing, the Update option will update the drawing entities to reflect those changes. The drawing entities will not be changed until you use this option. If text was not originally retrieved from the drawing, use the paste function discussed above. Choose Change style to change the current style. The settings of the current style are shown on this control panel: ╔════════════════════════╗ ║ F10 to accept entries ║ ║Use TAB to access styles║ ╚════════════════════════╝ ╔═══════════════════╗ ║Style: 18 ║ ║Font file: ROMANS ║ ║Height: 0.125 ║ ║Oblique: 0 ║ ║Width: 0.8 ║ ║Backwards? N ║ ║Upsidedown? N ║ ╚═══════════════════╝ Style control panel Select any component of the style to change it and redefine the current style. To switch the current style to another style, press Tab, and the names of all of the defined styles will be offered in the Style menu. Choosing one from the list will make it the current style. ╔════ SELECT ═════╗ ║116 ║ ║14 ║ ║18 ║ ║316 ║ ║332 ║ ║564 ║ ║OPEN ║ ║SOLID ║ ║STANDARD ║ ╚═════════════════╝ Style menu To round out your control over drawing text, the Text mode option lets you set the justification for the Update and Paste functions. Select a mode offered on the menu: ┌───────┐ │Left │ │Right │ │Center │ │Middle │ │Fit │ │Aligned│ └───────┘ Text mode SPELL ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌──────────────┐ ║ ░ │Spell file │ ║ ░ │spell Word │ ║ ░ │spell Drawing │ ║ ░ │spell Reset │ ║ ░ └──── Elsa ────┘ ║ The Spell menu gives you the power to check the spelling of the current buffer, the word at the cursor, or the text and attributes of your drawing. Choosing to spell check your drawing will give you the same selection options as Get text on the Dwgtext menu. No matter what the origin of the text, spell checking will occur with a window like this: ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ░Cement Content: 5 bags per cubic yard of concrete, minimum. ║ 1.0 ║ ░GENERAL: ║ ░Except for those specified, no admixtures will be permitted ║ ░Standards: Comply with recommendations of National Concrete ║ ░as used in shop. Use galvanizing repair on damaged galvanized ║ ░Masonry Association (NCMA). ║ ░unless approved by the owner's representative. ║ ░3.0 ║ ░1.1 ║ ░ ║ ░ ╔══════════════════════════════════════════════════════════════╗ ║ ░ ║Current Word: admixtures admitters ║ ║ ░ ╟──────────────────────────────────────────────────────────────╢ ║ ░ ║admitters adventures adventuress ║ ║ ░ ║adventurer adventurers adventureship ║ ║ ░ ║adventuresome adventuresses adventurish ║ ║ ░ ║adventurism admissions admissive ║ ║ ░ ╟──────────────────────────────────────────────────────────────╢ ║ ░ ║ Add Ignore Type Exit ==> ║ ║ ░ ╚══════════════════════════════════════════════════════════════╝ ║ ░ ║ ╚══════════════════════════════════════════════════════════════════════════════╝ Checking... Line 20 Col 1 │#│ │ │¢ Spell Check window The spell checker will stop when it finds a word not in the dictionaries [See the WCEdit Files appendix]. The misspelled word is shown in the Spell Check window at Current Word:. A list of possible words is shown, and the closest word found is shown next to the Current Word. Press Enter to replace the Current Word with the word suggested and continue the spell check. You may also pick another word from the list. If the Current Word is correct, you may choose Add to add it to the dictionary, or Ignore to skip this word. By replacing or ignoring a word, you choose to do so for the remainder of the Spell Check. Picking Type will let you type in the replacement word, and Exit will cancel the Spell Check. SUPPORT ╔═══ Files ══ Commands ══ Language ══ Options ══ Dwgtext ══ Spell ══ supporT ══╗ ┌────────────────────┐║ ░ │ supporT │║ ░ │ Register │║ ░ │ accelerator Boards │║ ░ │ Questions/answers │║ ░ └─────── Elsa ───────┘║ Looking for support for your registered copy of WCEdit? Wondering how to register this amazing shareware? Need specs on the hottest graphics accelerator board available? Puzzled by all the jargon surrounding state-of-the-art video these days? Look no further. The supporT menu has the answers to all of these enigmas. APPENDIX A - CONFIGURING WCEDIT CONFIGURATION FILES The initial state of the editing environment can be established in the configuration file. Screen colors, margins, and other variables may be preset. Individual keys and key combinations may be associated with commands, or in other words, functions may be assigned to keystrokes. Keys may be associated with trigger functions or to external user-written AutoLISP routines [see WCEDIT.LSP and WCFUNCS.LSP]. External functions are also made available on a menu inside the editor, accessed via the trigger function "SELECT_COMMAND" [F10 by default]. While several keys may be assigned to the same function, the inverse is not true; You may not assign a key to more than one function. See WCCONFIG in this section for information on assigning functions to keys. A configuration file typically includes the following WCEdit commands: WC_COLORS ( WC_COLORS( text background border_back border_text highlight_text highlight_back white_space )) WC_COLORS uses ANSI color codes [integers] as arguments. Using unique colors for various applications adds variety and helps users identify which function they are in [try that with a dialogue box]. The default colors are shown in WCFUNCS.LSP. The ANSI color codes are as follows: 0 BLACK 1 BLUE 2 GREEN 3 CYAN 4 RED 5 MAGENTA 6 BROWN 7 LIGHTGRAY 8 DARKGRAY 9 LIGHTBLUE 10 LIGHTGREEN 11 LIGHTCYAN 12 LIGHTRED 13 LIGHTMAGENTA 14 YELLOW 15 WHITE See the RE_COLOR function in WCFUNCS.LSP for some examples. WC_HELP_FILE ( WC_HELP_FILE "filespec" ) Loads file given for use in help window. Filespec can include drive, path, and filename. WC_SETVAR & WC_TOGGLE ( WC_TOGGLE "variable" ) and ( WC_SETVAR "variable" int ) Several modes may be controlled in the editor by setting WCEdit internal variables. They may be set discretely with the WC_SETVAR function, or toggled using the WC_TOGGLE command. For example, ( WC_SETVAR "WHITE_ON" 0) would turn off white space highlighting, and ( WC_TOGGLE "INSERT_MODE") would change the insert mode to it's opposite state. WCEDIT VARIABLES These are the WCEdit variable names, their default value, and a description of what they control: ACONFIG 1 When ON, all changes in configuration, such as variables, colors, resolutions etc., are saved when the program unloaded. If the variable is OFF, changes to the configuration file may only be performed by explicitly writing them out under the option 'Write config file' available from the pull-down menus. AUTO_INDENT 0 Turns automatic indentation on. Uses LMARGIN or beginning column of previous line to calculate indention for a new line. BOOKIND 5 The first line of a paragraph will be indented this many characters when performing paragraph reformats. Setting it to 1 will prevent indenting. BSPACE_WRAP 1 Causes the backspace key to 'wrap' up to the previous line when at column 1. COMMENTS 1 Parentheses inside AutoLISP comments [;like (this)] are disregarded during parentheses checking. When turned off, comment checking is only performed when checking forwards in a buffer. DOUBLEKEY 0 Causes the key strokes Ctrl-q, Ctrl-o, & Ctrl-k to wait for an additional key stroke to entered. You may use this variable to create a WordStar compatible key stroke layout. FULLVIEW 1 Expands the filename to full filespec in the Files Select window. INSERT_MODE 0 Sets the insert mode on. The cursor will show the current mode. See the variable RCURSOR. KCHAIN 0 Kills the undo list at every save function. LMARGIN 0 Sets the left margin for use in word wrapping, paragraph reforming, AutoLISP reforming and auto-indentation. MSSPEED 1 Sets the speed at which scrolling occurs with the mouse in use. 0 slowest - 5 fastest. NEXTFILE 0 Causes the find and replace function to jump to next file automatically. NORTON 0 Causes the key strokes F4, F5, F6, & F7 to wait for an additional key stroke to entered. You may use this variable to create a Norton compatible key stroke layout. PAINT 0 Colors contents of parentheses levels to be colored in addition to parentheses. PRELOAD 0 Preloads the dictionary before performing a spell check, instead of as-needed. QOPEN Quiets the 'percent loaded' display when files which were previously loaded (SEE WCEDIT.STS) are automatically reloaded into the editor at startup. RCURSOR 0 Turning this on will reverse the size of the cursor indicating the insert mode; Insert will be small, and typeover will be large. RMARGIN 80 Sets the right margin for use in word wrapping, paragraph reformatting, and right justification. SHOWEND 0 When this variable is set to an ascii value of 1 to 255, that ascii value is used to show where the actual end of line is. A value of 250 is a favorite ascii character. SMART_DELKEY 1 Deletes block, or deletes character if no marks are set. When set to 0, only deletes current character. Note: With this variable on, deleted marked text is NOT copied to the scrap buffer. See function BCUT. TABWIDTH 5 Sets a fixed tab width for the Editor. This width is also used to replace tabs in files being loaded into WCEdit and for pretty printing. TOCASE 0 Controls case sensitivity in find / find and replace functions. WORDWRAP 1 Turns on word wrapping. When typing past the right margin, the cursor and any truncated words are moved down to following line. WCCONFIG ( WCCONFIG "function_name" key_code_as_real <"description"> ) This is the primary function used in configuring the editor. WCCONFIG declares a function with WCEdit and associates a keystroke [literally an ascii-scancode] with that function. You may add a function 'on the fly' with the AutoLISP program ADD_NAME which is accessible from the Command Menu [F10] or with F8. The first parameter to the function is a string representing the name of the function you wish to use. If the function is one of the internal functions [trigger commands] then that command will be executed each time the key represented by key_code is entered. For example: The code for the F5 key is 16128. If you wanted to assign the internal command "FIND" to this key you would place: (wcconfig "FIND" 16128.0 ) in the file WCCONF.LSP. Notice the key code is passed to WCEdit as a real. This is because of an ADS limitation on long integers. Reals will be required in future versions of WCEdit. You must also be sure that no other definition in the file also contains this code [16128] since only the last definition will be used in configuration. If the value of code is 0 [ ( WCCONFIG "" 0 ) ] then all previously defined definitions to keys will be removed, and the defaults put in place. This is not normally needed since key definitions are overwritten each time a key code that was previously defined is reentered. There is also a second special case of in which the string passed is "" [nothing in it]. This will remove only the declaration of that key from the list. For example: Suppose you had defined the 'a' key to be some function, say "FIND_AND_R", and you wished to redefine the key to it's original status. Entering (wcconfig "" 7777.0) at the AutoCAD command prompt, or through the EVAL_FUNC AutoLISP function available through the command window [F10 - See below], would return that key to it's standard definition. The WCEdit functions are described in detail in the next section, PROGRAMMING. "Function_name" is the name of an WCEdit trigger function or a user defined external function. WCEdit executes functions by evaluating the name passed into WCEdit as "Function_name" when the function was defined. Trigger functions are executed by the editor. External functions are returned, in a list, back to the routine that called WCEdit. The AutoLISP function that called WCEdit then handles the call. For example, when C:WC receives a list from WCEdit, it calls the PROCESS function, passing it a list of ( scan_code "function_name"). PROCESS then performs an EVAL on the "function_name" and control is then returned to C:WC, which calls the editor again. The "function_name" could be handled by other methods also. The drawing file WCFLOW.DWG contains a flow chart that will help you visualize this procedure. See WC.LSP and WCFUNCS.LSP for examples, and WCEdit TRIGGERS on the next page. Key_code is the scancode for the desired key. For example, the scancode for the Ctrl-Enter key combination is 7178. Use the supplied AutoLISP routine, GETCODE, to easily acquire the scancode for keys and type them into your file for you. See WC.LSP for further examples. You will notice that several functions are set the fictitious scancode, 1. This allows you declare functions with the editor, without assigning a keystroke to them. These functions may still be called via the SELECT_COMMAND function. APPENDIX B - PROGRAMMING WCEDIT Having "an editor in AutoCAD, and AutoCAD in your editor," means that you can call AutoCAD functions from inside WCEdit, and WCEdit functions from AutoCAD. Both via AutoLISP. This allows you to write WCEdit 'macros,' using AutoLISP, that execute both WCEdit and AutoCAD functions. WCEdit also gives you hooks for using windows to prompt users for information and display messages. You need not be in WCEdit to call most of it's functions, in the same way that many AutoCAD functions work from the text screen. But WCEdit maintains the current working position, and responds appropriately. Therefore: 1. Both programs have functions that implicitly redraw or refresh the screen. 2. Just as the AutoCAD graphics screen does not always reflect the current state of the drawing database, the WCEdit screen may not show your changes until a WC_REFRESH is called. WCEdit returns one of 3 possibilities: A list of the scan code and function name; A string of the file name [for loading purposes]; or nil. If WCEdit is called with a parameter, WCEdit will assume that this is an error message and will display it as such. For instance, ( WCEDIT "File not found!" ) would display a window containing the string "File not found!". See WC.LSP for programming examples. TRIGGER FUNCTIONS Trigger functions are WCEDit commands that may be assigned to a key[s] using WCCONFIG or the Function Control Panel. Each command has three associated parts: 1) A description string for the command, which may be changed. 2) A default key stroke assignment for the command, which may be changed. See DEFAULT KEYS, page 22, for a listing. 3) The name of the function, which may not be changed. This trigger word is designed so that the description for the command may be altered, but the command itself may always be identified by this name. All AutoLISP access to commands are by this trigger string. Functions are listed with the type of argument required as: FUNCTION argument The description of each function, and explanation, and, if necessary, examples are supplied. Unless specifically noted, the functions will return nothing of interest. CURSOR MOVEMENT ENDOFFILE" To end of file" Moves position to end of last line of buffer. GOTOL "Goto line" Prompts the user for a line number to go to. NEXT_WORD "Move to next word" Advances position to next word. PREV_WORD "Move to previous word" Retreats position to previous word. TOPOFFILE "To top of file" Moves position to column 1, line 1 of buffer. EDITING FUNCTIONS CENTER_LINE "Center current line" Centers text of current line between margins. CLEAN_ALL_WHITE "Remove all trailing white space" Removes all trailing spaces from the entire file. DEL_FILLED "Delete block and fill with space" Delete block and fill with space. DELETE_LINE "Delete this line" Deletes the current line. DELETE_TO_BEG "Delete to beginning of line" Deletes everything to the left of the cursor position. Cursor position is left untouched. DELETE_TO_END "Delete to end of line" Deletes from current position to the end of line. DOBACKSPACE "Do standard backspace" Performs a standard backspace function. This may be assigned to any key, for emulating other editors. DOENTER "Do standard enter" Performs a standard enter function. This may be assigned to any key, for emulating other editors. DOINSERT "Toggle insert mode" Toggles the mode of character insertion from overstrike to insert and vice versa. DOPGDN "Do standard page down" Performs a standard page down function. This may be assigned to any key, for emulating other editors. DOPGUP "Do standard page up" Performs a standard page up function. This may be assigned to any key, for emulating other editors. DOTABKEY "Do standard tab key" Performs a standard WCEdit tab function [inserting TABWIDTH spaces]. This may be assigned to any key, for emulating other editors. INSERT_LINE_A "Insert a blank line above" Inserts a blank line above current position. KPAUSE Pauses a macro playback until a key is pressed. Returns the scancode of that key. Assign KPAUSE to a key, and press that key while recording a macro to cause the playback to pause. See also PLAYBACK, RECORD, SPLAY variable, WC_STUFFKEY, WC_STUFF_MACRO, and WC_GET_MACRO. NOKEY "Assign this key to nothing" Prevents the printing of a key in a document. The key may still be assigned to a function. For example, it is usually undesirable for escape to put a character in your document, but desirable for escape to function in exiting menus. PLAYBACK "Play back the current key stroke macro" Executes, or plays, the current keystroke macro. The current macro is the one just recorded [see RECORD] or the macro file loaded with WC_STUFF_MACRO. See also KPAUSE, RECORD, SPLAY variable, WC_STUFFKEY, and WC_GET_MACRO. PPRINT_ALL "Pretty print/format the AutoLISP file" Formats the current AutoLISP file by parenthesis, the tab, and LMARGIN settings. Automatically detects the indent level at which the line should be placed via parenthesis and strings. For example, If this were your lines of code in the file; (defun test(a / b);function test (if a ;test if a (progn ;set up branch (princ a);print the value of a (princ "Not a") ;no value to print ) ) ) After formatting the text, with a TABWIDTH of 5, would be; (defun test(a / b);function test (if a ;test if a (progn ;set up branch (princ a);print the value of a (princ "Not a") ;no value to print ) ) ) ) Left justification will be added with LMARGIN spaces. Therefore be sure to set the variable to a desired value prior to formatting via ( WC_SETVAR "LMARGIN" nn ). RECORD "Record and End record a key stroke macro" Starts and ends recording a key stroke macro. Returns 1 if recording was started, 0 if ended. See also PLAYBACK, SPLAY variable, WC_STUFFKEY, WC_STUFF_MACRO, and WC_GET_MACRO. REFORM "Reformat block into paragraph" Reformats the lines of the currently blocked text to fit between the current values of LMARGIN and RMARGIN. The block is treated as a line block. For example, if LMARGIN = 5, RMARGIN = 40, then this; 0 5 40 : : : THIS IS A TEST TO CHECK OUT THE REFORMATTING OF BLOCKED PARAGRAPHS. THE FIRST COLUMN SHOULD BE AT 5 AND THE LAST COLUMN SHOULD BE AT 40. would be reformatted to this; 0 5 40 : : : THIS IS A TEST TO CHECK OUT THE REFORMATTING OF BLOCKED PARAGRAPHS. THE FIRST COLUMN SHOULD BE AT 5 AND THE LAST COLUMN SHOULD BE AT 40. SETMARK "Set an undo mark" Sets an undo marker for the UBACK command. Works like the AutoCAD Undo/Mark command. SQUARE "Reform paragraph with right justification" Reformats the current paragraph as described in REFORM. The right edge, however, will be justified by evenly padding each line with spaces, like this: 0 5 40 : : : THIS IS A TEST TO CHECK OUT THE REFORMATTING OF BLOCKED PARAGRAPHS. THE FIRST COLUMN SHOULD BE AT 5 AND THE LAST COLUMN SHOULD BE AT 40. TCASE "Toggle case of marked text" Changes the case of blocked text to upper or lower case. A prompt asking the user to hit the up or down arrow key determines whether the case will be upper or lower. UBACK "Undo back" Undo back is similar to AutoCAD's Undo/Back command. Uback will undo changes to a buffer until it hits an undo mark. If no undo mark is set, you will be asked if you wish to undo everything. UGROUP "Undo last command" This is the standard undo command, similar to the AutoCAD U command. Any changes made to buffers may be undone with this command. Once all undos have been performed a message is displayed stating that all is undone. There is a limit to the amount that may be undone, but it is doubtful you will ever reach it. UPDATETEXT "Update selected drawing text" Updates AutoCAD drawing file text has been selected for editing. This is the same command accessed from the Dwgtext pull-down menu. SCRAP-BUFFER BCUT "Delete marked text or line to scrap" Copies the marked text to the scrap buffer and deletes the text. If no text is marked, then the current line will be copied to the scrap buffer and deleted. BEGIN_COL_MARK "Begin a column mark" Starts a column mark at current position. BEGIN_INC_MARK "Begin an inclusive mark" Starts an inclusive mark at current position. BEGIN_LINE_MARK "Begin a line mark" Starts a line mark at current position. CUT_PASTE "Cut and paste block" Moves blocked text to current location, disturbs scrap buffer, DEL_MARKED "Delete marked text" Delete's text from the current column position to the end of line. Disturbs scrap buffer in doing so and unhighlights the block. DUMP_SCRAP "Paste in the scrap buffer" Inserts the contents of the scrap buffer at the current position. When text is put into the scrap buffer the marking method is saved for insertion purposes [see the blocking status, #3, in WC_STATISTICS]. Before insertion of scrap, you may use "BEGIN_COL_MARK" or "BEGIN_LINE_MARK" to alter the insertion behavior between mark and column modes. DUMP_TO_SCRAP "Copy block to scrap buffer" Copies the blocked text to the scrap buffer. This overwrites any text in the scrap buffer. Unhighlights block. Marks can be retrieved through WC_STATISTICS, or rehighlighted with the trigger function REMARK. END_MARK "End the mark" Drops the end marker at current position, used for both line and character marks, ERASE_MARKS "De-highlight block" Unhighlights marks, sets mark status to 0, mark locations can still be retrieved with WC_STATISTICS. IMPORTSC "Import screen to scrap" Imports the AutoCAD text screen contents into the scrap buffer for subsequent insertions. REMARK "Re-highlights previous block" Re-highlights previous marks, useful when a function has unhighlighted the block. See WC_STATISTICS for the locations of the marks. DISK COUTPUT Change output file name Changes the name of the current buffer to another file name. No check is made for file existence of the new filespec. Subsequent file writes are made to the new file name. HARD_WRITE_ALL "Write all files to disk" Writes all files with no prompt. NEW_FILE "Create/Load a new file" Reads a file into a new buffer, pops up window prompting for name of file. READ_IN_FILE "Read in another file" Appends file to active buffer at cursor position. SELECT_FILE "Edit/Delete another buffer" Pops up window for selecting new buffer from list of buffer names. UHARD "Write the current buffer to disk" Write the active buffer to disk, no questions asked, returns 1 on success, # on error. UNCOND_SAVEX int "Save-as and exit to AutoCAD" Writes to file and exits, no prompts, returns 1 on success, # on error. WRITE_FILE_TO int "Write file to ..." Writes to file with prompt for filename, returns 1 on success, # on error. INQUIRY ASCIIC "Ascii chart" Pops up the ASCII chart. CALCULATOR "Calculator" Pops up the calculator. See Language menu/calculaTor for examples. COMMANDS "Pop up the commands window" Pops up the Command window. The functions in the Command window may be changed from the Function control panel. DO_ALL_BRACKET int "Test all parenthesis in file" Checks buffer for matching parenthesis and quotes, returns 1 on success, 0 on failure. When programming, use ( WC_STATISTICS ) to get position in buffer prior to initiation. FILESTRING "Build string find list" Pops up window prompting for multi-file search string. Search results in window containing list of buffers containing string. FIND "Find" Pops up window prompting for text to find in current buffer. FIND_AND_R "Find and replace" Pops up windows prompting for text to find and replace, prompts for replacement. See variable NEXTFILE for automatically continuing search in next buffer. NUMBERS "Insert a column of numbers" Prompts the user for beginning number, ending number, and an incrementation. The numbers from beginning to end, in increments, will be inserted into the file starting at the current cursor position downward, one line per number. For example, beginning = 10, ending = 0 and incrementation = 2 would insert the following numbers: 10 8 6 4 2 0 REPFIND "Repeat last find" Repeats the previous find. RUNLISP "Run a non-registered AutoLISP routine Prompts for the name of an AutoLISP function to run. WCEdit will automatically be exited from to run this function. Provided your program runs smoothly, without an error, you will be returned to the editor. If an error occurs, you must reenter the editor via 'WC' at the AutoCAD command prompt. This is handy for quickly testing your AutoLISP routines. SELECT_COMMAND "Run a registered AutoLISP routine" Pops up menu containing definitions of all declared external functions. If no definition was supplied in the configuration, the name of the function is displayed. Functions may be executed by selecting a definition from the menu. This is the same function as run from the Commands menu. SINGLE_BRACKET "Find match for this parenthesis" Checks for single matching parenthesis or quotes. Call with cursor on parenthesis or quote, moves position to match if found, returns 1 on success, 0 on failure. The variable entitled 'Ignore comments in bracket test' [COMMANDS] is used by this command. If the variable is OFF, the contents of comments [;] will be considered. However, if the variable is ON, comments will be ignored. TIMEDATE "Insert time and date stamp" Displays the current time and date in a window. Striking the ENTER key results in the time and date string being inserted at the cursor position in the buffer. VIEWFILE "View a file" Prompts the user for a file to view using the file dialog box. The dialog box will reappear until the user has canceled the request with the Escape key. WINDOWS MAKE_ONE "Zoom the current buffer to full" Zoom current window to full screen. PAINTL "Color paint the parenthesis" Toggles the parenthesis color-coding for LISP and 'C' files. The levels of colors will repeat themselves after the ninth level. See the PAINT variable for control of paint method.0 POP1 "Pop first window" Pops the first pull down menu entitled 'Files'. POP2 "Pop second window" Pops the second pull down menu entitled 'Commands'. POP3 "Pop third window" Pops the third pull down menu entitled 'Language'. POP4 "Pop fourth window" Pops the fourth pull down menu entitled 'Options'. POP5 "Pop fifth window" Pops the fifth pull down menu entitled 'Dwgtext'. POP6 "Pop sixth window" Pops the sixth pull down menu entitled 'Spell'. QUIT "Quit to AutoCAD" Exits from editor. No work is lost. Buffers are retained in editor. ROTATE_WINDOWS "Rotate vertical/horizontal windows" Rotate windows alternately to vertical or horizontal. SPLIT_CENTER_R "Split the screen at center horizontally" Split the screen vertical centered. SPLIT_CENTER_U "Split the screen at center vertically" Split the screen horizontal centered. SPLIT_RIGHT "Split the screen at position vertically" Split the screen right at column. SPLIT_UP "Split the screen at position horizontally Alt 4" Split the screen at current row. TOGGLE_FILE "Toggle to next buffer" Toggles window to next buffer. TOGGLE_WINDOW "Toggle to next window" Toggles to other window if in split screen mode. VIEW_HELP "View the help" Pops up help window displaying the file last loaded by ( wc_help_file ), editing is not allowed. VIEW_SCRAP "View the scrap buffer" Pops up scrap buffer for viewing and editing. ZAP "Remove the current buffer" Remove the active buffer. Prompts if file has not been saved. ** For more advanced windowing and message functions ** ** try MAGIC, also from Walt Craig. ** WCEDIT LISP FUNCTIONS Functions are listed as ( FUNCTION argument ) value_returned. Some of WCEdit's functions return data, such as cursor location, chars, and strings. The action performed by the function is described and other nuggets are reported. Unless specifically noted, the function returns nothing of interest. CURSOR MOVEMENT ( WC_COL int ) int Description; Absolute move to column n, Arguments;row number as an integer [rows start @ 0]. Returns;if n = -1 then returns current column number, doesn't move. Example; (setq col (wc_col -1)) (wc_col (nth 1 old)) ( WC_MOVE_DOWN int ) int Description; Relative move down by n lines. Arguments;number of lines to move down as an integer. Returns;returns the number of lines moved. Example; (setq n (wc_move_down 2)) ( WC_MOVE_LEFT int ) int Description; Relative move left by n columns. Arguments;number of columns to move left as an integer. Returns;returns the number of columns moved. Example; (setq n (wc_move_left 1)) ( WC_MOVE_RIGHT int ) int Description; Relative move right by n columns. Arguments;number of columns to move right as an integer. Returns;returns the amount moved. Example; (setq n (wc_move_right 5)) ( WC_MOVE_UP int ) int Description; Relative move up by n lines. Arguments;number of line to move up as an integer. Returns;returns the amount moved. Example; (wc_move_up 1) ( WC_RACE_END int ) Description; Moves current position to end of line, bottom of page, or bottom of file. Arguments;if integer is: 0 then end of line, 1 then bottom of screen 2 then bottom of buffer. Returns;nothing of interest Example; (wc_race_home 2) (wc_trigger "begin_line_mark") (wc_race_end 2) ( WC_RACE_HOME int ) Description; Moves current position to home, top of page, or top of file. Arguments;if integer is: 0 then beginning of line, 1 then top of screen, 2 then top of buffer. Returns;nothing of interest Example; (setq row (wc_row -1)) (setq col (wc_col -1)) (wc_race_home 2) ( WC_ROW int ) int Description; Absolute move to row n, Arguments;row number as an integer [rows start @ 0] Returns;if n = -1 then return current row number, don't move. Example; (setq row (wc_row -1)) EDITING ( WC_ADD_STRING string ) Description; Concatenates the current line with a supplied string. Arguments;string to add. Returns;nothing of interest Example; (wc_add_string (strcat "Page "(itoa page))) ( WC_BREAK_LINE ) Description; Inserts a carriage return at the current position. Arguments;none Returns;nothing of interest Example; (wc_trigger "next_word") (wc_break_line) ( WC_CLEAN_LEFT ) Description; Removes leading spaces from the current line. Arguments;none Returns;nothing of interest Example; (wc_clean_left) (setq str (wc_get_string) ... ( WC_CLEAN_RIGHT ) Description; Removes trailing spaces from the current line. Arguments;none Returns;nothing of interest Example; (wc_clean_right) (setq str (wc_get_string) ... ( WC_DOUBLE_KEY real string ) Description; Tests if a scancode equals a character or a Shift, Alt or Ctrl combination of that letter. Arguments;( WC_DOUBLE_KEY real string ) a scancode as a real, and the character to compare it to, as a string. Returns;Returns 1 if true, 0 if false. Example; (if (wc_double_key 32736 "Enter") (progn ... ( WC_DEL_CHAR ) Description; Deletes the current character, and causes a wrap if the character is beyond the end of line. Arguments;none Returns;nothing of interest Example; (wc_del_char) ( WC_FIRST_KEY string ) real Description; Retrieves the first key assignment found [several keys may be assigned the same function]. Arguments;a function/trigger as a string. Returns;returns the 1st assignment to a key found as a real, or nil if the function is not found. Example; (wc_first_key (nth 1 list)) ( WC_FLUSH_BUFFER ) Description; Deletes contents of active buffer, maintains name of buffer. !WARNING! No check is performed to test for file not being saved. You must perform this yourself with this function. Use WC_CLEAR_SCRAP to flush scrap buffer. See also WC_REMOVE_BUFFER and ZAP. Arguments;none Returns;nothing of interest Example; (wc_flush_buffer) (wc_race_home 2) (wc_trigger "dump_scrap") ( WC_GET_MACRO ) list Description; Gets the current macro for analysis or storage. Arguments;none Returns;a list of scancodes [as reals] which represent the 'current' macro, or nil if no macro is defined. Example; (setq lst(wc_get_macro)) (setq key(wc_message "Hit the key to assign" 0)) (if (/= key 283.0) (progn ... ( WC_GFUNC real ) list Description; Gets the statistics about a function that is assign to a key. Arguments;a key scancode as a real. Returns;WC_GFUNC returns a list of (int string1 string2) where: int = 0 means that the function assigned to key is a trigger function int = 1 for external AutoLISP function, String1 is the trigger/function name, String2 is the description. or nil is returned if the key is not assigned to anything. Example; (setq lst (wc_gfunc i)) (if lst (progn ... ( WC_GKEY "keyname" ) real Description; Gets the key value for the keyname passed as a string. Keyname must be exact and the function is case sensitive. See KEYS.LST for a list of exact keys. Arguments;key name as string. Returns;nothing of interest Example; (wc_gkey "Ctrl D") would return 8196.0 ( WC_GNAME real ) string Description; Gets the name of a key. Arguments;scancode as a real. Returns;returns the key value as a string when passed a key code, returns "" if no string associated with this key value was found in internal list. Example; (wc_gname 8196) returns "Ctrl D" ( WC_OVERSTRIKE string ) Description; Places a the first character of string at current position as if insert mode were off. Arguments;new character as a string. Returns;nothing of interest Example; (setq str (strcase char dir)) (wc_overstrike str) ( WC_REPLACE_LINE string ) Description; Replaces the current line with string. Arguments;new string. Returns;nothing of interest Example; (wc_replace_line (strcat ";;;Revised on: " (gdate))) ( WC_STUFF_CHAR string ) Description; Inserts character at the current position, ignores all but first char of string. Arguments;character as a string. Returns;nothing of interest Example; (wc_stuff_char "{") ( WC_STUFFKEY real ) Description; Stuffs a key scancode into the editor for evaluation. May be used to write 'intelligent' macros. See RECORD, PLAYBACK, WC_GET_MACRO AND WC_STUFFMACRO, . Arguments;scancode as a real. Returns;nothing of interest Example; (wc_stuffkey (nth index lst)) ( WC_STUFFMACRO list ) Description; Accepts a list of real numbers which represent a key macro. This list becomes the 'current' macro, which PLAYBACK will execute. See also RECORD, PLAYBACK, WC_GET_MACRO and WC_STUFFKEY. Arguments;none Returns;executes macro Example; (wc_stuffmacro "spell.chk") (wc_trigger "playback") ( WC_TRIGGER "command_string" ) Description; Causes WCEdit to execute an trigger command, see the list of trigger commands in CONFIGURING WCEDIT, page 35. Arguments;WCEdit trigger command as a string. Returns; nil Example; (wc_trigger "TOGGLE_FILE") (if(= i (nth 18 (wc_statistics))) (progn ... ( WC_TRIMENDS string ) string Description: Removes leading and trailing spaces from a string. Arguments;String. Returns;String. Example; (setq str(wc_trimends " THIS IS A STRING ")) ;;; str is now "THIS IS A STRING" ( WC_WRAP_UP ) Description; Wraps the line below to the end of the current line. Arguments; none Returns; nothing of interest Example; (wc_wrap_up) SCRAP-BUFFER ( WC_CLEAR_SCRAP ) Description; Cleans out the scrap buffer, use WCFLUSH_BUFFER to clear text buffer. Arguments; none Returns; nothing of interest Example; (wc_clear_scrap) DISK File_string refers to a filespec consisting of a drive, path, and filename passed as a string, such as "D:\\ACAD\\MYHELP.HLP". ( WC_DIRBOX string ) string Description: Brings up the standard file I/O dialogue box with a title passed as the string. Arguments; Title for box. Returns; file_string, or nil if canceled. Example; (setq filename(wc_dirbox "LispLoader")) ( WC_HELP_FILE file_string ) Description; Sets filespec of file to be displayed by VIEW_HELP. Arguments; filespec as a string. Returns; nothing of interest Example; (wc_help_file "helpme.txt") ( WC_NEW_FILE file_string ) Description; Reads file into new buffer, use FINDFILE first if running in silent mode to avoid errors being written to screen, maximum number of buffers is two hundred. Arguments; filespec as a string. Returns; nothing of interest Example; (if(setq str(findfile fname)) (wc_new_file str) ... ( WC_HARD_WRITE ) int Description; Writes buffer to file with no prompt. Arguments; none Returns; return Example; (wc_hard_write) ( WC_VIEW_FILE string ) int Description: Brings up the standard file viewer box with the file passed within for browsing. Arguments; file_string. Returns; INT if file was found, or nil if not found. Example; (wc_viewfile "SPECS.TXT") ( WC_WRITE_SCRAP file_string ) int Description; Writes scrap buffer to file, use ( FINDFILE ) to check first, will overwrite existing file!. Arguments; filespec as a string. Returns; returns 1 on success, # on error. Example; (wc_write_scrap "cabinet.txt") ( WC_WRITE_TO_FILE file_string ) int Description; Write active buffer to file_string, use FINDFILE to check first, will overwrite existing file!, Arguments; filespec as a string. Returns; returns 1 on success, # on error. Example; (setq str (wc_fetch_string str " Enter file name " "escape to cancel" )) (if str (wc_write_to_file str)) ( WC_READ_IN_FILE file_string ) Description; Inserts file at cursor position, uses line mark mode, verify file exists with FINDFILE if working in silent mode. Arguments; filespec as a string. Returns; nothing of interest Example; (if(setq str(findfile fname)) (wc_read_in_file str) ... INQUIRY ( WC_CASTCHAR real ) string Description; Converts a scancode to string. Arguments; scancode to analyse. Returns; key name as a string. Example; (setq answer (wc_castchar answer)) (if (or (= answer "Y") (= answer "y")) (setq answer 't) ... and (wc_castchar 8196) would return "" ( WC_FETCH_INT string int int ) int Description; Draws a dialogue box for allow the user to edit an integer, Arguments; ( WC_FETCH_INT "prompt" field_len default ) prompt is displayed in the border, field length is the maximum number of digits accepted, and default is placed in the window for editing. Returns; returns integer or nil. Example; (setq n (wc_fetch_int " Enter number to cipher " 6 100)) ( WC_FETCH_REAL string int real ) real Description; Draws a dialogue box for allow the user to edit a real, Arguments; ( wc_fetch_real "prompt" field_len default ) prompt is displayed in the border, field length is the maximum number of digits accepted, and default is placed in the window for editing. Returns; returns real, or nil. Example; (setq n (wc_fetch_real " Enter your temperature " 4 98.6)) ( WC_FETCH_STRING string string string ) string Description; Draws a dialogue box containing string for the user to edit, remarks are embedded in border of box. Arguments; (wc_fetch_string string_to_edit "top_remark" "bottom_remark") Returns; returns the edited string, or nil if canceled. Example; (setq str (wc_fetch_string str " Enter file name " "escape to cancel" ) ) ( WC_FIND string ) int Description; Moves the position to the first occurrence of string. Arguments; string to find. Returns; returns 1 if found, nil otherwise. Example; (if (wc_find "my keys") (princ "I found them honey! ) ) ( WC_FIND_REPLACE string string int ) int Description; Finds string and replaces it integer times, if times < 0 then a global replace happens. Arguments; ( WC_FIND_REPLACE "find" "replace" times ) Returns; returns the number of changes. Example; ( wc_find_replace "qedit" "wcedit" 0 ) ( WC_GET_CHAR ) string Description; Give access the character at the current position. Arguments; none Returns; Returns the character at the current position, nil if past end of line or buffer. Example; (wc_next_word 0) (setq n (wc_get_char)) ( WC_GET_STRING ) string Description; Retrieves the current line of text. Arguments; none Returns; current line. Example; (setq s (wc_get_string)) ( WC_GETVAR string ) int Description; Gets value of a WCEdit variable. Arguments; name of variable. Returns; value of variable. Example; (setq n (wc_getvar "rmargin")) ( WC_NEXT_CHAR ) string Description; Advances position to next character. Arguments; none Returns; returns the next character or nil at eof. Example; (setq n (wc_next_char)) ( WC_NEXT_WORD ) string Description; Advances position to next word, depends on WC_SET_WORDS for spaces to skip. Arguments; none Returns; returns the next word. Example; (setq n (wc_next_word)) ( WC_PREV_CHAR ) string Description; Retreats the position back to previous character. Arguments; none Returns; returns the previous character. Example; (setq n (wc_prev_char)) ( WC_PREV_WORD ) string Description; Retreats position to previous word, depends on WC_SET_WORDS for spaces to skip. Arguments; none Returns; returns previous word. Example; (setq n (wc_prev_word)) ( WC_SETVAR string int ) Description; Sets WCEdit variable named string to int. Arguments; ( WC_SETVAR name_of_variable value ) Returns; nothing of interest Example; (setvar "lmargin" 5) ( WC_STATISTICS ) list Description; Used to retrieve the vital statistics for the editor. Handy for saving current status for later reestablishment. Arguments; none Returns; a list where the nth item represents: n type data 0 string left or Main buffer name with path. 1 string right buffer name with path. 2 int number of lines in file, starts w/ line no. 1. 3 int blocking in effect in active buffer: 0 = none 1 = yes 4 int mark type: 1 = line 2 = block 5 int key code of last key entered. 6 int column number of first column in window. 7 int row number of first row in window. 8 int markx1 [starting column]. 9 int marky1 [starting row]. 10 int markx2 [ending column, may be before starting column]. 11 int marky2 [ending row, may be above starting row]. 12 int file changed = 1. 13 int number buffers in editor. 14 int The current side of screen may have the following values for the active buffer's position and also may be used to establish the windowing scenario in affect: 0 - Single window. 1 - Vertical windows. Current is right. 2 - Vertical windows. Current is left. 3 - Horizontal windows. Current is top. 4 - Horizontal windows. Current is bottom. 15 int current x position on screen [starts @ 0]. 16 int current y position on screen [starts @ 0]. 17 string Help file name with path. 18 int current file index - which file out of nth 13. 19 int current line mode [25,43 or 50]. Example; (setq ok (nth 12 (wc_statistics))) (if (= ok 1) ... See the function GCNAME in WCFUNCS.LSP for an example of how to get the active buffer's name. SCREEN ( WC_BEEP real real ) Description; Sounds the speaker. Arguments; ( WC_BEEP freq duration ) Both arguments are non-zero positive reals. Returns; nothing of interest Example; (if (not (wc_find str)) (wc_beep 5000.0 9000.0) (wc_print "Can't find Jack!") ) ( WC_CENTER_ATX ) Description; This centers the screen about the current column. If the current column is left of center, then the current column is adjusted. Arguments; none Returns; nothing of interest Example; (wc_race_end 0) (wc_center_atx) ( WC_CENTER_ATY ) Description; This centers the screen about the current row. If the current row is above the center, then the current row is adjusted. Arguments; none Returns; nothing of interest Example; (wc_find "your string here") (wc_center_aty) ( WC_CLS ) Description; Clears the entire screen using the colors defined with WC_COLORS, uses the background color. Arguments; none Returns; nothing of interest Example; (wc_cls) (wc_window ... ( WC_DISPLAY x1 y1 string ) Description; Displays text on the screen. This is used generally with WC_WINDOW to display text in the window. Arguments; ( WC_DISPLAY x1 y1 message ) x1 column to start message, y1 row to start message, message your message here. Returns; nothing of interest Example; (wc_window 3 1 40 3 1 1) (wc_display 6 2 "Files Editor Special") (wc_window 3 4 15 15 1 1) (wc_display 4 5 "About") ... ( WC_GETCURS ) list Description; Returns the position of the cursor on the screen. Arguments; none Returns; list as ( row col ) relative to upper left corner [0,0]. Example; (setq where (wc_getcurs)) ( WC_MESSAGE string int ) real Description; Displays a window containing a message. Arguments; ( WC_MESSAGE message int ) If the integer is: 0 the function returns the integer scan code for the key pressed and closes the window. 1 the window is left on the screen until an trigger or external (WC_REFRESH) occurs. Returns; nothing of interest Example; (setq answer (WC_message "File exists! Overwrite? N" 0)) (if (or (= answer "Y") (= answer "y")) ... ( WC_MOUSE int ) Description; Sets initial use of mouse on or off. This may be called only once prior to entry into the editor [(wcedit)]. Typically used in a configuration file. Arguments; 0 no mouse, 1 use mouse. Returns; nothing of interest. Example; (WC_help_file "MYHELP.HLP"); (WC_colors '(14 1 4 7 14 0 2)) (WC_mouse 0) ( WC_PAD_LEFT int ) Description; This function adds n spaces to the beginning of the current line. Arguments; ( WC_PAD_LEFT n ) where n is any positive integer. Returns; nothing of interest Example; (setq tabw (WC_getvar "TABWIDTH")) (WC_silent 1) (wc_race_home 0) (wc_trigger "NEXT_WORD") (WC_pad_left tabw) ( WC_PRINT string ) Description; Prints a custom message on the bottom line of screen, message stays until overwritten or refresh 1 is called. See WC_MESSAGE for further message tools. Arguments; message. Returns; nothing of interest Example; (wc_setvar "PPRINT" 1) (WC_PRINT "AutoLISP formatting on RETURNS"); ( WC_REFRESH int ) Description; Redraws the screen to reflect changes made in editor. Allows several functions to be performed before updating the screen, increasing the speed of programs and improving the appearance. Turns silent mode off. A redraw is implicit in many trigger functions. See WC_SILENT. Arguments; 0 Redraws the text window[s] only, 1 Redraws both the text window[s] and the status line. Returns;nothing of interest Example; (wc_silent 0) (wc_col col) (wc_row row) (wc_center_aty) (wc_refresh 1) ( WC_REMOVE_BUFFER int ) Description; This function will delete/remove a buffer from memory. !WARNING! BE SURE THAT YOU ARE DELETING WORK! Use statistic's 12th element to test if the file has been changed. The function takes one argument as an integer in the form ( WC_REMOVE_BUFFER index ), where a file index may be obtained from statistics. You are not allowed to delete/remove a buffer which is under view or the only buffer in the editor - see ZAP for this feature. The editor must maintain at least one buffer at all times. A possible use for this function is the operate on sections of text files in the background, via-cut paste, and remove it when done. Arguments; ( WC_REMOVE_BUFFER int ) Returns; nothing of interest. Example; (if(= i (nth 18 (wc_statistics))) (wc_message "Attempted to delete active buffer!" 0) (wc_remove_buffer i) ) ( WC_SETCURS int int ) Description; Sets the cursor to position x1,y1. This has no effect upon the current position within the editor itself. This is for use with the WINDOW, DISPLAY, and TMENU functions. Arguments; (wcsetcurs x1 y1) Returns; nothing of interest. Example; (wc_window 10 3 70 6 1 2) (wc_display 12 4 "Go to dos (1) Command (2)") (wc_setcurs 23 12) Places the cursor under the default (1). ( WC_SETMODE_NOW int ) int Description; Used for changing or resetting the video mode after entering the editor. Arguments; 0 25 line, 1 43/50 line, Returns; the number of lines displayed. Example; (wc_print "This is 50 line mode ") (wc_setmode_now 1) (wc_print "This is 25 line mode ") (wc_setmode_now 0) ( WC_SHAVE ) Description; Arguments; none. Returns; nothing of interest Example; (wc_shave) ( WC_SILENT int ) Description; Disables the display of all movement, editing, or other changes. Useful for suppressing messages returned by functions, using another buffer in the background, or to manipulate an file while in the drawing editor. Arguments; 0 Turns on display, 1 Turns off all screen display until either WC_REFRESH, re- enter editor turned on, or critical message occurs. Returns; nothing of interest. Example; (WC_silent 1) (setq reply (WC_append_scrap_to fname)) (WC_silent 0) (if (not reply) ... ( WC_TMENU string int list ) int Description; Allows you to query the user for an item using a scrollable dialogue box Arguments; ( wc_tmenu "title" default_position_integer (list of strings) ) the string "title" is displayed in the border, default position is highlight initially, each string in the list is an item for selection. Returns; an integer for the item picked [nth item of list] or nil if canceled. Example; (setq a (wc_tmenu " Title " _curconf_ (setq lst (list " Editor1 " " Editor2 " " Editor3 " ) ) ) ) Displays a menu for selecting a configuration with the current configuration [ set in _curconf_ ] highlighted. ( WC_VER ) real Description; Returns the version of WCEdit that is running. Arguments; none. Returns; a real number [currently 1.04]. Example; (setq curver (wc_ver)) ( WC_WINDOW int int int int int int ) Description; Draws a window on the screen from corners x1,y1 to x2,y2. Arguments; ( WC_WINDOW x1 y1 x2 y2 height border ) x1,x2 screen column from left y1,y2 screen row from top height apparent depth of shadow in characters border type of border, accepts; 0 none 1 single line 2 double line Returns; nothing of interest. Example; (wc_cls) (wc_window 10 3 70 6 1 2) (wc_display 12 4 " WCEdit allows you to tailor the editor.") (wc_display 12 5 " Select a demo item to review.") Displays a window with upper left corner at col-10,row-3 to lower right corner at col-70,row-6 [4 rows high and 61 columns wide]. It has an apparent height (shadow) of 1 character and a double lined border. The messages are then displayed in the window with WC_DISPLAY. ** For more advanced windowing and message functions ** ** try MAGIC V3.0, also from Walt Craig. ** INDEX About 18 ACONFIG 36 Ascii cHart 27 ASCIIC 49 AUTO_INDENT 36 BCUT 46 BEGIN_COL_MARK 47 BEGIN_INC_MARK 47 BEGIN_LINE_MARK 47 Blocking 12 BOOKIND 37 BSPACE_WRAP 37 Buffer List 18 Buffers 6, 18 CalculaTor 28, 49 CCOLOR 37 CENTER_LINE 43 Change style 31 Check all Parentheses 26 CLEAN_ALL_WHITE 43 Color mode toggle 25 Colors 29 COMMANDS 19, 49 Configure Keys 20 COUTPUT 48 CTABS 37 CUT_PASTE 47 DEFAULT KEYS 22 DEL_FILLED 43 DEL_MARKED 47 DELETE_LINE 43 DELETE_TO_BEG 43 DELETE_TO_END 43 DO_ALL_BRACKET 49 DOBACKSPACE 43 DOENTER 43 DOINSERT 43 DOPGDN 43 DOPGUP 43 DOTABKEY 44 DUMP_SCRAP 47 DUMP_TO_AC 37 DUMP_TO_SCRAP 47 DWGTEXT 30 END_MARK 47 ENDOFFILE 42 ERASE_MARKS 47 Files 6, 17, 18 FILESTRING 49 FIND 49 FIND_AND_R 49 Get text 30 GOTOL 42 HARD_WRITE_ALL 48 Help 25 High resolution 29 IMPORTSC 47 INSERT_LINE_A 44 INSERT_MODE 37 JUMP_QUOTES 37 KPAUSE 44 LANGUAGE 25 LAST_SCRAP 37 List Selected entities 26 Low resolution 29 MAKE_ONE 50 Match parenthesis 25 MMARK 37 Mouse 30 New 18 NEW_FILE 48 NEXT_WORD 42 NEXTFILE 37 NOKEY 44 NUMBERS 49 OPTIONS 29 PAINT 38 PAINTL 51 Paste 30 PLAYBACK 44 POP 51 PPRINT 38 PPRINT_ALL 44 PREV_WORD 42 QOPEN 38 Quit 17, 19, 51 RCURSOR 38 Read in 18 READ_IN_FILE 48 RECORD 45 REFORM 45 Reformat file <Lisp> 25 REMARK 48 REP_FIND 50 RePlace 18 Reset defaults 24 RMARGIN 38 ROTATE_WINDOWS 51 Run AutoLISP function 28 RUNLISP 50 Save 17 Save/eXit 18 SELECT_COMMAND 50 SELECT_FILE 48 SETMARK 45 SILENT 38 SINGLE_BRACKET 50 SPELL 32 SPLAY 38 SPLIT_CENTER_R 51 SPLIT_CENTER_U 51 SPLIT_RIGHT 51 SPLIT_UP 52 SQUARE 45 SUPPORT 34 TCASE 46 Text mode 32 TIMEDATE 50 TOCASE 39 Toggle file 18 TOGGLE_FILE 52 TOGGLE_WINDOW 52 TOPOFFILE 42 UBACK 46 UGROUP 46 UHARD 48 UNCOND_SAVEX 48 Update 31 UPDATETEXT 46 Variables 20 VIEW_HELP 52 VIEW_SCRAP 52 VIEWFILE 50 WC_ADD_STRING 55 WC_BEEP 70 WC_BREAK_LINE 55 WC_CASTCHAR 64 WC_CENTER_ATX 70 WC_CENTER_ATY 71 WC_CLEAN_LEFT 56 WC_CLEAN_RIGHT 56 WC_CLEAR_SCRAP 62 WC_CLS 71 WC_COL 53 WC_COLORS 35 WC_DEL_CHAR 57 WC_DIRBOX 62 WC_DISPLAY 71 WC_DOUBLE_KEY 56 WC_FETCH_INT 65 WC_FETCH_REAL 65 WC_FETCH_STRING 65 WC_FIND 66 WC_FIND_REPLACE 66 WC_FIRST_KEY 57 WC_FLUSH_BUFFER 58 WC_GET_CHAR 66 WC_GET_MACRO 58 WC_GET_STRING 67 WC_GETCURS 72 WC_GETVAR 67 WC_GFUNC 58 WC_GKEY 59 WC_GNAME 59 WC_HARD_WRITE 63 WC_HELP_FILE 36, 62 WC_MESSAGE 72 WC_MOUSE 72 WC_MOVE_DOWN 53 WC_MOVE_LEFT 53 WC_MOVE_UP 54 WC_NEW_FILE 62 WC_NEXT_CHAR 67 WC_NEXT_WORD 68 WC_OVERSTRIKE 59 WC_PAD_LEFT 73 WC_PREV_CHAR 68 WC_PREV_WORD 68 WC_PRINT 73 WC_RACE_END 54 WC_RACE_HOME 55 WC_READ_IN_FILE 64 WC_REFRESH 74 WC_REMOVE_BUFFER 74 WC_REPLACE_LINE 60 WC_ROW 55 WC_SETCURS 74 WC_SETMODE_NOW 75 WC_SETVAR 36, 68 WC_SILENT 76 WC_STATISTICS 69 WC_STUFF_CHAR 60 WC_STUFFKEY 60 WC_STUFFMACRO 60 WC_TMENU 76 WC_TOGGLE 36 WC_TRIGGER 61 WC_TRIMENDS 61 WC_VER 75, 77 WC_WINDOW 77 WC_WRAP_UP 61 WC_WRITE_SCRAP 63 WC_WRITE_TO_FILE 64 WCCONFIG 39 WHITE_ON 39 Write config file 24 Write to 18 WRITE_FILE_TO 48 ZAP 52